/ Developer CD Series 1999 …ember: Reference Library / Apple Developer Reference Library (December 1999) (Disk 1).iso / pc / technical documentation / develop / develop issue 18 / develop issue 18 code / pwrpc 601 µs timer.sea / PwrPC 601 µs Timer / Timer Readme

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 0c 54 69 6d 65 72 20 | 52 65 61 64 6d 65 00 00 |..Timer |Readme..|
|00000010| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 54 45 58 54 4d 50 53 | 20 01 00 00 00 00 00 00 |.TEXTMPS| .......|
|00000050| 00 00 00 00 00 08 63 00 | 00 01 ac a9 a5 51 a2 a9 |......c.|.....Q..|
|00000060| a5 51 a2 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |.Q......|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 5f 68 00 00 |........|...._h..|
|00000080| 23 0d 23 20 46 69 6c 65 | 3a 09 09 09 54 69 6d 65 |#.# File|:...Time|
|00000090| 72 20 52 65 61 64 6d 65 | 0d 23 0d 23 20 57 72 69 |r Readme|.#.# Wri|
|000000a0| 74 74 65 6e 20 62 79 3a | 09 44 61 76 65 20 45 76 |tten by:|.Dave Ev|
|000000b0| 61 6e 73 0d 23 0d 23 20 | 43 6f 70 79 72 69 67 68 |ans.#.# |Copyrigh|
|000000c0| 74 3a 09 a9 20 31 39 39 | 34 20 62 79 20 41 70 70 |t:.. 199|4 by App|
|000000d0| 6c 65 20 43 6f 6d 70 75 | 74 65 72 2c 20 49 6e 63 |le Compu|ter, Inc|
|000000e0| 2e 2c 20 61 6c 6c 20 72 | 69 67 68 74 73 20 72 65 |., all r|ights re|
|000000f0| 73 65 72 76 65 64 2e 0d | 23 0d 23 20 49 27 76 65 |served..|#.# I've|
|00000100| 20 70 72 6f 76 69 64 65 | 64 20 74 68 65 20 54 69 | provide|d the Ti|
|00000110| 6d 65 72 2e 73 20 61 73 | 73 65 6d 62 6c 79 20 66 |mer.s as|sembly f|
|00000120| 69 6c 65 20 61 6e 64 20 | 69 74 73 20 72 65 73 75 |ile and |its resu|
|00000130| 6c 74 69 6e 67 20 54 69 | 6d 65 72 2e 6f 20 6f 62 |lting Ti|mer.o ob|
|00000140| 6a 65 63 74 20 66 69 6c | 65 20 74 6f 20 68 65 6c |ject fil|e to hel|
|00000150| 70 0d 23 20 79 6f 75 20 | 70 72 6f 66 69 6c 65 20 |p.# you |profile |
|00000160| 74 69 6d 65 20 63 72 69 | 74 69 63 61 6c 20 50 6f |time cri|tical Po|
|00000170| 77 65 72 50 43 20 63 6f | 64 65 2e 20 20 49 74 20 |werPC co|de.  It |
|00000180| 70 72 6f 76 69 64 65 73 | 20 74 68 72 65 65 20 72 |provides| three r|
|00000190| 6f 75 74 69 6e 65 73 20 | 74 68 61 74 20 72 65 61 |outines |that rea|
|000001a0| 64 20 74 68 65 0d 23 20 | 50 6f 77 65 72 50 43 20 |d the.# |PowerPC |
|000001b0| 36 30 31 20 52 65 61 6c | 20 54 69 6d 65 20 43 6c |601 Real| Time Cl|
|000001c0| 6f 63 6b 20 28 52 54 43 | 29 20 72 65 67 69 73 74 |ock (RTC|) regist|
|000001d0| 65 72 73 20 61 6e 64 20 | 72 65 74 75 72 6e 20 65 |ers and |return e|
|000001e0| 69 74 68 65 72 20 74 68 | 65 20 72 61 77 20 76 61 |ither th|e raw va|
|000001f0| 6c 75 65 73 20 6f 72 20 | 61 0d 23 20 6d 69 63 72 |lues or |a.# micr|
|00000200| 6f 73 65 63 6f 6e 64 20 | 72 65 73 75 6c 74 2e 20 |osecond |result. |
|00000210| 20 49 20 72 65 63 6f 6d | 6d 65 6e 64 20 74 68 61 | I recom|mend tha|
|00000220| 74 20 79 6f 75 20 72 65 | 61 64 20 74 68 65 20 6d |t you re|ad the m|
|00000230| 69 63 72 6f 73 65 63 6f | 6e 64 20 76 61 6c 75 65 |icroseco|nd value|
|00000240| 20 62 65 66 6f 72 65 20 | 61 6e 64 20 61 66 74 65 | before |and afte|
|00000250| 72 0d 23 20 79 6f 75 72 | 20 63 72 69 74 69 63 61 |r.# your| critica|
|00000260| 6c 20 63 6f 64 65 20 74 | 6f 20 65 73 74 69 6d 61 |l code t|o estima|
|00000270| 74 65 20 74 68 65 20 73 | 70 65 65 64 20 6f 66 20 |te the s|peed of |
|00000280| 69 74 73 20 65 78 65 63 | 75 74 69 6f 6e 2e 20 20 |its exec|ution.  |
|00000290| 54 68 65 20 74 77 6f 20 | 72 65 67 69 73 74 65 72 |The two |register|
|000002a0| 73 2c 20 52 54 43 55 0d | 23 20 61 6e 64 20 52 54 |s, RTCU.|# and RT|
|000002b0| 43 4c 20 70 72 6f 76 69 | 64 65 20 61 20 73 65 63 |CL provi|de a sec|
|000002c0| 6f 6e 64 20 63 6c 6f 63 | 6b 20 28 52 54 43 55 29 |ond cloc|k (RTCU)|
|000002d0| 20 61 6e 64 20 61 20 6e | 61 6e 6f 73 65 63 6f 6e | and a n|anosecon|
|000002e0| 64 20 63 6c 6f 63 6b 20 | 28 52 54 43 4c 29 2e 20 |d clock |(RTCL). |
|000002f0| 20 50 6c 65 61 73 65 20 | 72 65 66 65 72 0d 23 20 | Please |refer.# |
|00000300| 74 6f 20 74 68 65 20 50 | 6f 77 65 72 50 43 20 36 |to the P|owerPC 6|
|00000310| 30 31 20 52 49 53 43 20 | 4d 69 63 72 6f 70 72 6f |01 RISC |Micropro|
|00000320| 63 65 73 73 6f 72 20 55 | 73 65 72 27 73 20 4d 61 |cessor U|ser's Ma|
|00000330| 6e 75 61 6c 20 66 6f 72 | 20 61 20 66 75 72 74 68 |nual for| a furth|
|00000340| 65 72 20 64 69 73 63 75 | 73 73 69 6f 6e 20 6f 66 |er discu|ssion of|
|00000350| 0d 23 20 74 68 65 73 65 | 20 72 65 67 69 73 74 65 |.# these| registe|
|00000360| 72 73 20 61 6e 64 20 68 | 6f 77 20 74 6f 20 65 66 |rs and h|ow to ef|
|00000370| 66 65 63 74 69 76 65 6c | 79 20 75 73 65 20 74 68 |fectivel|y use th|
|00000380| 65 6d 2e 0d 23 0d 23 20 | 54 68 61 6e 6b 73 20 67 |em..#.# |Thanks g|
|00000390| 6f 20 74 6f 20 4d 69 6b | 65 20 4e 65 69 6c 20 66 |o to Mik|e Neil f|
|000003a0| 6f 72 20 64 65 73 69 67 | 6e 69 6e 67 20 61 6e 64 |or desig|ning and|
|000003b0| 20 69 6d 70 6c 65 6d 65 | 6e 74 69 6e 67 20 74 68 | impleme|nting th|
|000003c0| 69 73 20 6c 69 62 72 61 | 72 79 2c 20 61 6e 64 20 |is libra|ry, and |
|000003d0| 66 6f 72 20 61 6c 6c 6f | 77 69 6e 67 20 0d 23 20 |for allo|wing .# |
|000003e0| 6d 65 20 74 6f 20 72 65 | 6c 65 61 73 65 20 69 74 |me to re|lease it|
|000003f0| 20 66 6f 72 20 79 6f 75 | 72 20 75 73 65 2e 20 20 | for you|r use.  |
|00000400| 4d 69 6b 65 27 73 20 61 | 20 72 65 61 6c 6c 79 20 |Mike's a| really |
|00000410| 73 68 61 72 70 20 67 75 | 79 20 69 6e 20 44 65 76 |sharp gu|y in Dev|
|00000420| 65 6c 6f 70 65 72 20 54 | 65 63 68 6e 69 63 61 6c |eloper T|echnical|
|00000430| 20 0d 23 20 53 75 70 70 | 6f 72 74 20 61 6e 64 20 | .# Supp|ort and |
|00000440| 61 20 70 72 6f 20 61 74 | 20 70 72 6f 66 69 6c 69 |a pro at| profili|
|00000450| 6e 67 20 50 6f 77 65 72 | 50 43 20 63 6f 64 65 2e |ng Power|PC code.|
|00000460| 0d 23 0d 23 20 54 68 69 | 73 20 6c 69 62 72 61 72 |.#.# Thi|s librar|
|00000470| 79 20 77 69 6c 6c 20 6f | 6e 6c 79 20 6f 70 65 72 |y will o|nly oper|
|00000480| 61 74 65 20 6f 6e 20 61 | 20 50 6f 77 65 72 50 43 |ate on a| PowerPC|
|00000490| 20 36 30 31 20 70 72 6f | 63 65 73 73 6f 72 2e 20 | 601 pro|cessor. |
|000004a0| 20 4e 6f 20 66 75 74 75 | 72 65 20 70 72 6f 63 65 | No futu|re proce|
|000004b0| 73 73 6f 72 73 2c 0d 23 | 20 6e 6f 72 20 4d 61 63 |ssors,.#| nor Mac|
|000004c0| 69 6e 74 6f 73 68 20 70 | 72 6f 64 75 63 74 73 20 |intosh p|roducts |
|000004d0| 62 61 73 65 64 20 6f 6e | 20 74 68 6f 73 65 20 66 |based on| those f|
|000004e0| 75 74 75 72 65 20 70 72 | 6f 63 65 73 73 6f 72 73 |uture pr|ocessors|
|000004f0| 2c 20 77 69 6c 6c 20 73 | 75 63 63 65 73 73 66 75 |, will s|uccessfu|
|00000500| 6c 6c 79 0d 23 20 65 78 | 65 63 75 74 65 20 74 68 |lly.# ex|ecute th|
|00000510| 69 73 20 54 69 6d 65 72 | 20 63 6f 64 65 2e 20 20 |is Timer| code.  |
|00000520| 42 75 74 20 79 6f 75 20 | 77 69 6c 6c 20 66 69 6e |But you |will fin|
|00000530| 64 20 69 74 20 75 73 65 | 66 75 6c 20 66 6f 72 20 |d it use|ful for |
|00000540| 70 72 6f 66 69 6c 69 6e | 67 20 79 6f 75 72 20 63 |profilin|g your c|
|00000550| 6f 64 65 0d 23 20 6f 6e | 20 74 68 65 20 50 6f 77 |ode.# on| the Pow|
|00000560| 65 72 50 43 20 36 30 31 | 20 70 72 6f 63 65 73 73 |erPC 601| process|
|00000570| 6f 72 2e 0d 23 0d 23 20 | 44 4f 20 4e 4f 54 20 55 |or..#.# |DO NOT U|
|00000580| 53 45 20 54 48 49 53 20 | 4c 49 42 52 41 52 59 20 |SE THIS |LIBRARY |
|00000590| 49 4e 20 59 4f 55 52 20 | 53 48 49 50 50 49 4e 47 |IN YOUR |SHIPPING|
|000005a0| 20 50 52 4f 44 55 43 54 | 53 2e 20 20 57 65 20 61 | PRODUCT|S.  We a|
|000005b0| 72 65 20 70 72 6f 76 69 | 64 69 6e 67 20 69 74 20 |re provi|ding it |
|000005c0| 74 6f 20 79 6f 75 20 6f | 6e 6c 79 0d 23 20 66 6f |to you o|nly.# fo|
|000005d0| 72 20 64 65 76 65 6c 6f | 70 6d 65 6e 74 20 70 75 |r develo|pment pu|
|000005e0| 72 70 6f 73 65 73 2e 20 | 20 59 6f 75 20 61 72 65 |rposes. | You are|
|000005f0| 20 6e 6f 74 20 66 72 65 | 65 20 74 6f 20 72 65 6c | not fre|e to rel|
|00000600| 65 61 73 65 20 74 68 69 | 73 20 63 6f 64 65 2e 20 |ease thi|s code. |
|00000610| 20 59 6f 75 20 6d 61 79 | 20 6e 6f 74 20 0d 23 20 | You may| not .# |
|00000620| 72 65 64 69 73 74 72 69 | 62 75 74 65 20 69 74 20 |redistri|bute it |
|00000630| 69 6e 20 79 6f 75 72 20 | 70 72 6f 64 75 63 74 73 |in your |products|
|00000640| 2e 20 20 49 66 20 79 6f | 75 20 6e 65 65 64 20 73 |.  If yo|u need s|
|00000650| 69 6d 69 6c 61 72 20 74 | 69 6d 69 6e 67 20 69 6e |imilar t|iming in|
|00000660| 66 6f 72 6d 61 74 69 6f | 6e 20 69 6e 20 79 6f 75 |formatio|n in you|
|00000670| 72 0d 23 20 70 72 6f 64 | 75 63 74 73 20 75 73 65 |r.# prod|ucts use|
|00000680| 20 74 68 65 20 70 75 62 | 6c 69 63 20 4d 69 63 72 | the pub|lic Micr|
|00000690| 6f 73 65 63 6f 6e 64 73 | 20 72 6f 75 74 69 6e 65 |oseconds| routine|
|000006a0| 20 64 65 73 63 72 69 62 | 65 64 20 62 65 6c 6f 77 | describ|ed below|
|000006b0| 2e 0d 23 0d 23 20 59 6f | 75 20 6d 61 79 20 61 6c |..#.# Yo|u may al|
|000006c0| 73 6f 20 63 61 6c 6c 20 | 74 68 65 20 72 6f 75 74 |so call |the rout|
|000006d0| 69 6e 65 20 4d 69 63 72 | 6f 73 65 63 6f 6e 64 73 |ine Micr|oseconds|
|000006e0| 20 64 65 66 69 6e 65 64 | 20 69 6e 20 74 68 65 20 | defined| in the |
|000006f0| 4d 61 63 69 6e 74 6f 73 | 68 20 6f 6e 20 52 49 53 |Macintos|h on RIS|
|00000700| 43 20 53 44 4b 0d 23 20 | 69 6e 20 74 68 65 20 49 |C SDK.# |in the I|
|00000710| 6e 74 65 72 66 61 63 65 | 20 66 69 6c 65 20 54 69 |nterface| file Ti|
|00000720| 6d 65 72 2e 68 20 74 68 | 65 72 65 2e 20 20 54 68 |mer.h th|ere.  Th|
|00000730| 69 73 20 72 6f 75 74 69 | 6e 65 20 77 69 6c 6c 20 |is routi|ne will |
|00000740| 70 72 6f 76 69 64 65 20 | 4d 69 63 72 6f 73 65 63 |provide |Microsec|
|00000750| 6f 6e 64 0d 23 20 74 69 | 6d 69 6e 67 20 6f 6e 20 |ond.# ti|ming on |
|00000760| 61 6c 6c 20 50 6f 77 65 | 72 20 4d 61 63 69 6e 74 |all Powe|r Macint|
|00000770| 6f 73 68 20 70 72 6f 64 | 75 63 74 73 2c 20 62 75 |osh prod|ucts, bu|
|00000780| 74 20 77 68 65 6e 20 75 | 73 69 6e 67 20 69 74 20 |t when u|sing it |
|00000790| 79 6f 75 20 73 68 6f 75 | 6c 64 0d 23 20 63 61 6c |you shou|ld.# cal|
|000007a0| 6c 20 69 74 20 61 20 66 | 65 77 20 74 69 6d 65 73 |l it a f|ew times|
|000007b0| 20 66 69 72 73 74 20 74 | 6f 20 65 73 74 69 6d 61 | first t|o estima|
|000007c0| 74 65 20 74 68 65 20 72 | 6f 75 74 69 6e 65 73 20 |te the r|outines |
|000007d0| 69 6e 74 65 72 6e 61 6c | 20 6f 76 65 72 68 65 61 |internal| overhea|
|000007e0| 64 2e 20 20 49 74 20 6d | 61 79 20 68 61 76 65 0d |d.  It m|ay have.|
|000007f0| 23 20 64 69 66 66 65 72 | 65 6e 74 20 67 72 61 6e |# differ|ent gran|
|00000800| 75 6c 61 72 69 74 79 20 | 61 6e 64 20 6f 76 65 72 |ularity |and over|
|00000810| 68 65 61 64 20 6f 6e 20 | 64 69 66 66 65 72 65 6e |head on |differen|
|00000820| 74 20 50 6f 77 65 72 50 | 43 20 70 72 6f 63 65 73 |t PowerP|C proces|
|00000830| 73 6f 72 73 2e 20 20 54 | 68 65 20 72 6f 75 74 69 |sors.  T|he routi|
|00000840| 6e 65 0d 23 20 61 6c 73 | 6f 20 6d 61 79 20 68 61 |ne.# als|o may ha|
|00000850| 76 65 20 61 20 73 69 67 | 6e 69 66 69 63 61 6e 74 |ve a sig|nificant|
|00000860| 6c 79 20 6c 6f 77 65 72 | 20 67 72 61 6e 75 6c 61 |ly lower| granula|
|00000870| 72 69 74 79 20 63 6f 6d | 70 61 72 65 64 20 74 6f |rity com|pared to|
|00000880| 20 74 68 65 20 50 6f 77 | 65 72 50 43 20 36 30 31 | the Pow|erPC 601|
|00000890| 0d 23 20 6e 61 6e 6f 73 | 65 63 6f 6e 64 20 72 65 |.# nanos|econd re|
|000008a0| 67 69 73 74 65 72 2e 20 | 20 42 75 74 20 79 6f 75 |gister. | But you|
|000008b0| 20 6d 61 79 20 75 73 65 | 20 74 68 61 74 20 72 6f | may use| that ro|
|000008c0| 75 74 69 6e 65 20 69 6e | 20 79 6f 75 72 20 73 68 |utine in| your sh|
|000008d0| 69 70 70 69 6e 67 20 70 | 72 6f 64 75 63 74 73 2e |ipping p|roducts.|
|000008e0| 0d 23 0d 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |.#......|........|
|000008f0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000900| 00 00 01 00 00 00 01 6e | 00 00 00 6e 00 00 00 3e |.......n|...n...>|
|00000910| 00 00 6a 40 0d 44 69 72 | 65 63 74 6f 72 79 4d 65 |..j@.Dir|ectoryMe|
|00000920| 6e 75 02 00 00 00 54 45 | 58 54 4d 50 53 20 01 00 |nu....TE|XTMPS ..|
|00000930| 0c 54 69 6d 65 72 20 52 | 65 61 64 6d 65 62 02 00 |.Timer R|eadmeb..|
|00000940| 00 00 54 45 58 54 4d 50 | 53 20 01 00 ff ff ff ff |..TEXTMP|S ......|
|00000950| 00 00 54 45 58 54 4d 50 | 53 20 01 00 ff ff ff ff |..TEXTMP|S ......|
|00000960| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000970| 00 00 a9 a5 19 62 00 00 | 08 63 00 00 01 ac 00 00 |.....b..|.c......|
|00000980| 00 00 00 00 00 00 00 00 | 0a 00 00 00 6a 40 04 44 |........|....j@.D|
|00000990| 6f 49 74 81 02 00 00 00 | 54 45 58 54 4d 50 53 20 |oIt.....|TEXTMPS |
|000009a0| 01 00 ff ff ff ff 00 00 | 00 00 6a 4d 00 00 00 00 |........|..jM....|
|000009b0| 17 be 00 00 20 00 00 00 | 00 00 05 3a 00 00 20 00 |.... ...|...:.. .|
|000009c0| a8 0f f1 b0 a8 0f f1 b0 | a8 7c c1 4d 00 00 00 00 |........|.|.M....|
|000009d0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 60 02 |........|......`.|
|000009e0| 00 01 00 00 00 00 00 00 | 00 00 60 06 00 01 00 00 |........|..`.....|
|000009f0| 00 00 00 00 00 00 00 00 | 00 00 0a 00 00 00 6a 40 |........|......j@|
|00000a00| 00 00 00 48 00 09 4d 6f | 6e 61 63 6f 00 6f 70 79 |...H..Mo|naco.opy|
|00000a10| 72 69 67 68 74 3a 09 a9 | 20 31 39 39 34 20 62 79 |right:..| 1994 by|
|00000a20| 20 41 70 70 6c 65 00 06 | 00 04 00 3d 00 2b 02 0d | Apple..|...=.+..|
|00000a30| 02 65 00 3d 00 2b 02 0d | 02 65 a9 a5 17 a8 00 00 |.e.=.+..|.e......|
|00000a40| 08 60 00 00 08 60 00 00 | 00 00 01 00 00 00 00 1e |.`...`..|........|
|00000a50| 00 3d 00 2b 02 0d 02 65 | 00 3d 00 2b 02 0d 02 65 |.=.+...e|.=.+...e|
|00000a60| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000a70| 01 00 00 00 01 6e 00 00 | 00 6e 00 00 00 3e 00 b0 |.....n..|.n...>..|
|00000a80| 93 38 0d 98 00 00 00 1c | 00 3e 00 00 4d 50 53 52 |.8......|.>..MPSR|
|00000a90| 00 01 00 0a 03 ed ff ff | 00 00 00 00 00 00 00 00 |........|........|
|00000aa0| 03 f0 ff ff 00 00 00 4c | 00 b2 e3 98 00 00 00 00 |.......L|........|
|00000ab0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000ac0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000ad0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000ae0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000af0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
+--------+-------------------------+-------------------------+--------+--------+